home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / mbase101.zip / Readme.1st < prev    next >
Text File  |  1997-05-02  |  17KB  |  443 lines
  1. This is the readme.1st file for RXDbase and MaxBase.
  2.  
  3. NOTE: Please see the end of this document to read about the license for this package.
  4. RXDbase is *not* freeware.
  5.  
  6. NOTE2: When you find errors in any of the applications in this package, please
  7. report them to maxmars@pianeta.it, along with the error dump (you can find
  8. that in the shell where you have launched the program) and an explanation
  9. of what you were doing.
  10.  
  11. HOW TO GET 'LATEST AND GREATEST'
  12. "'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'
  13.  
  14. E-mail to maxmars@pianeta.it .. Web page coming soon!
  15.  
  16.  
  17. DIFFERENCES FROM PUBLIC BETAS OF RXDBASE/MAXBASE
  18. "'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'
  19.  
  20. .) Added a Client/Server implementation of RXDbase (see directories
  21.    .\client and .\server) and MaxBase. Added an applet to publish
  22.    databases on the web.
  23. .) Completely reworked the UI interface. See changes in MaxBase.doc.
  24.    (I have dropped Jesse Hammons' ScrollPanel class, and used Taligent's
  25.     ListBox, which I have modificated a bit).
  26. .) Included an icon for all of the batch files.
  27. .) Updated the docs.
  28. .) Added an installation procedure for OS/2, with creation of WPS objects.
  29. .) Added a new plugin which prints your records.
  30. .) Corrected some bugs.
  31.  
  32.  
  33. INSTALLATION AND FIRST STEPS
  34. "'"'"'"'"'"'"'"'"'"'"'"'"'"'
  35.  
  36. Warning: you need long file names to use this product. (more than 8+3, that is)
  37.  
  38. Warning/2: this program heavily depends on the quality of your Java VM.
  39. Please get and install the latest release of the Java VM for your 
  40. computer/Operating System before running MaxBase.
  41.  
  42. The first step to take is to tell your computer where to find the MaxBase [.class] executables.
  43. I have included an install batch file for OS/2, but I would be glad to hear from users how to
  44. create similar installation procedures for other operating systems.
  45. PLEASE NOTE that the programs in this package WON'T run unless you have told your
  46. computer / O.S. where to find the .class files. 
  47.  
  48. As a reference, the OS/2 batch file adds to config.sys the line 
  49. SET CLASSPATH=x:\dir\.;x:\dir\NetRexxR.zip;x:\dir\taligent.zip;x:\dir\client;x:\dir\server;
  50. (or updates an existing SET CLASSPATH, if present) note that x:\dir is the directory where 
  51. you have placed MaxBase.
  52.  
  53.  
  54. 1. If you are not a Java or NetRexx programmer.
  55.  1.1 QuickStart for MaxBase local version.
  56.  1.2 QuickStart for MaxBase networked version.
  57.  1.3 Publishing databases on the World Wide Web.
  58.  
  59. 2. If you are a Java/NetRexx programmer.
  60.  2.1 Where to go from here now (library for local database)?
  61.  2.2 Where to go from here now (library for networked databases)?
  62.  2.3 Where to go from here now (plugins for MaxBase)?
  63.  
  64.  
  65. 1. If you are not a Java or NetRexx programmer:
  66.  
  67. 1.1 QuickStart for MaxBase local version:
  68.     ---------- --- ------- ----- --------
  69.  
  70. Just unzip plugins.zip (or MACplug, UNIXplug if you use Macs or Unices), then 
  71. type 'java MaxBase' and, via the GUI, connect to the database "imgs.dat".
  72. Select one or all of the entries in the database and click on the 
  73. "view text/image" button.
  74. runme.cmd, runme.bat batch files are provided for OS/2 and Windows users.
  75. If you are a user from another system or machine, and have created a batch
  76. file to automatize the launch of MaxBase (local DB app) and/or Sportello 
  77. (networked DB app, client side), RXDBServer (networked DB app, server side)
  78. please e-mail it to me at maxmars@pianeta.it.
  79.  
  80.  
  81. 1.2 QuickStart for MaxBase networked version:
  82.     ---------- --- ------- --------- --------
  83.  
  84. To run the server, you need to  use the batch files (runserver.cmd and 
  85. runserver.bat) to put the server to work. 
  86. If you launch RXDBServer.class without parameters, it will show you 
  87. its usage. Eg. type "java RXDBase" at the command prompt.
  88. ['runserver' is a batch file which issues 'java RXDBServer <parameters>']
  89.  
  90. To run the client, just launch runclient.cmd or runclient.bat giving as a 
  91. parameter the IP address of the machine which has an RXDBServer running,
  92. the port on which that server is running and (optional) the password for
  93. the server. Without a password, you will be able only to browse the remote
  94. database (but only if the remote server is operating in safe mode).
  95. Beware that in most Java implementations you cannot use dotted decimal 
  96. IP notation (unless you have some kind of host resolution hardiwred, as in 
  97. OS/2 Warp 4's C:\MPTN\ETC\HOSTS file)
  98. ['runclient' is a batch file which issues 'java Sportello <parameters>']
  99.  
  100. For example, I have set up my machine to act as 10.0.0.1, and when I
  101. do my tests I fire up the server then I launch "runclient.cmd 10.0.0.1".
  102.  
  103.  
  104. 1.3 Publishing databases on the World Wide Web.
  105.     ---------- --------- -- --- ----- ---- ----
  106.  
  107. Please refer to the SportelloApplet.doc file into the "client" directory
  108. to learn how to publish your databases on the web (warning: in that
  109. document it is assumed that you know how to mantain a web page).
  110.  
  111.  
  112.  
  113.  
  114. 2. If you are a Java/NetRexx programmer:
  115.  
  116. Warning: 
  117. ----------------------------------------------------------------------
  118. this package was created using NetRexx, a compiler (written in Java) which generates
  119. Java code. The programs generated by it (and all the programs here are such)
  120. need the NetRexx classes. A copy of these is here in this package, 
  121. file NetRexxR.zip. Just copy NetRexxR.zip in a directory that's in your
  122. CLASSPATH environment variable, and you're OK (no need to unzip them).
  123. Be sure to have .\. (./. or whatever your OS needs) in the classpath environment
  124. variable. 
  125.  
  126. More NetRexx info on my page or at http://www2.hursley.ibm.com
  127.  
  128. Read also the file 'license.txt' in the netrexx\lang directory that resides in
  129. NetRexxR.zip, because it contains the user license for those NetRexx classes. 
  130. License.txt doesn't apply to RXDbase and MaxBase, though: for those two, refer 
  131. to the .doc accompanying them.
  132.  
  133. From version 0.9 I've started using Taligent widgets. See Talicense.txt
  134. for the license.
  135. ----------------------------------------------------------------------
  136.  
  137. If you're interested in plugins for MaxBase and are using WinXX or OS/2, please
  138. unzip the file plugins.zip.
  139. If you are using a Mac unzip macplug.zip, and finally for Unix unzip unixplug.zip.
  140. Those packages differ for the included databases (in WinXX and OS/2 you have 
  141. newline = \r\n, in Mac = \r and in Unix = \n) and plugin.ini.
  142.  
  143.  
  144. 2.1 Where to go from here now (library for local database)?
  145.     ----- -- -- ---- ---- --- -------- --- ----- ---------
  146.  
  147. The file to read is RXDbase.doc. I have also put here some examples
  148. (dbtest.nrx and dbtest2.nrx) which are coded in NetRexx.
  149.  
  150.  
  151. 2.2 Where to go from here now (library for networked databases)?
  152.     ----- -- -- ---- ---- --- -------- --- --------- ----------
  153.  
  154. The Networked, client side classess for RXDbase come in the form of RXDBClient.doc
  155. in the .\client directory. There are no server side classes or APIs since it's
  156. all handled by the server.
  157.  
  158.  
  159. 2.3 Where to go from here now (plugins for MaxBase)?
  160.     ----- -- -- ---- ---- --- -------- --- ---------
  161.  
  162. Readme.plugins is the place where to start to learn more about plugins.
  163.  
  164. MaxBase can be customized with little effort by means of plugins.
  165. Plugins are small Java or NetRexx applications which communicate
  166. with MaxBase to get the list of fields and records which were
  167. selected at the moment that the user launched the plugin, and then
  168. do specific tasks.
  169.  
  170. Let's see it a bit better:
  171.  
  172. 1) The user selects some records in MaxBase.
  173. 2) The user pushes a plugin button from within
  174.    MaxBase, thus launching a plugin.
  175. 3) MaxBase fires up the plugin, and waits until
  176.    the plugin has finished initializing itself.
  177. 4) MaxBase sends the plugin info about the fields
  178.    of the current DB and the records which are selected.
  179. 5) Now it's up to the plugin: it can do whatever it wants
  180.    with those data.
  181.  
  182.  
  183. PLATFORM CONSIDERATIONS
  184. "'"'"'"'"'"'"'"'"'"'"'"
  185.  
  186. I did test this program only on OS/2 Warp 4 and Win32.
  187. If you're using it under other platforms, please drop
  188. me a note on your results with it.
  189.  
  190.  
  191. PLEASE BE VOCAL
  192. "'"'"'"'"'"'"'"
  193.  
  194. Yes, I need _your_ feedback on errors, incompatibilites, suggestions, etc.
  195. So far I'm testing it only on the OS/2 platform (and some
  196. tests are done also on Win32). I'd be interested on
  197. feedback also from users of other O.Ss. and platforms.
  198.  
  199.  
  200. LICENSE
  201. "'"'"'"
  202.  
  203. Why should you register?
  204. Because this way you:
  205.  
  206. A) Receive (via e-mail or snail mail) the uncrippled
  207.    version of MaxBase.
  208. B) Receive for free all the updates up to version 2 for
  209.    MaxBase. [Note: bug-fixes are always seen as 1.X,
  210.    and so do most of the improvements until the program
  211.    is really different from version 1.0, and this won't
  212.    happen in 1997 anyway - I plan to release 1 major
  213.    release for year, with discounts for people who 
  214.    already have an older version].
  215. C) Help the author decide that the developing of MaxBase
  216.    is a worthy cause, so he will be encouraged to add
  217.    many enhancements to it. :-)
  218.  
  219.  
  220.  
  221. With "program", it is intended the whole set of .class files included
  222. in this package.
  223.  
  224. If you have received this program as shareware, be warned that you
  225. have a period of 30 days to evaluate it, then you must choose:
  226.  
  227. 1) if you want to continue using this product, you must pay for it.
  228.  
  229. MaxBase can be registered via BMT-Micro - please see the end of the
  230. document.
  231.  
  232.  Register fees are:
  233.   US Dollars   29 .. for the standard edition (full local database
  234.                       + server able to receive 2 clients at once)
  235.   US Dollars   89 .. for the extended edition (full local database
  236.                       + server able to receive all the clients 
  237.                       it can handle at once)
  238.  
  239. 2) if you don't like this program, or are unable to contact the author,
  240. you *must* stop using the program and you *must* uninstall it after the
  241. 30 days period.
  242.  
  243. 3) If you build an application with RXDbase, a *small* one-time fee
  244. must be paid to the author (contact me for details).
  245.  
  246. 4) Non profit organizations: please contact me for details; discounts
  247. are available.
  248.  
  249. I am not responsible or liable in any way for any damages 
  250. deriving from the use of this product. Use it at your own risk.
  251.  
  252. The sources for RXDbase are not provided, and you cannot modify or disassemble
  253. the class, in any way. Also, you can not re-distribute this program unless
  254. you have the permission of the author (Max Marsiglietti).
  255.  
  256. RXDBase is (c) Max Marsiglietti 1996, 97.
  257.  
  258. See Also Talicense.txt (in the directory where you found this) and license.txt
  259. inside NetRexxR.zip.
  260.  
  261.  
  262.  
  263. CONTACTING THE AUTHOR
  264. "'""'"'"'""'"'"'""'"'
  265.  
  266. If you find any bug, or have suggestions, please 
  267. report all of your comments to:
  268.  
  269.  Max Marsiglietti, 
  270.  
  271.  E-mail:
  272.   maxmars@pianeta.it (Internet), 2:332/529.12 (Fidonet)
  273.  
  274.  Snail Mail:
  275.   V.Landino 13, 
  276.   41049, Sassuolo (MO)
  277.   Italy.
  278.  
  279.  
  280. REGISTERING VIA BMT - MICRO
  281. "'"'"'"'"'"'"'"'"'"'"'"'"'"
  282.  
  283.                   Mail Orders To: BMT Micro
  284.                                   PO Box 15016
  285.                                   Wilmington, NC 28408
  286.                                   U.S.A.
  287.  
  288.                     Voice Orders: 8:00am - 7:00pm EST (-5 GMT)
  289.                                   (800) 414-4268 (orders only)
  290.                                   (910) 791-7052
  291.  
  292.                       Fax Orders: (910) 350-2937  24 hours / 7 Days
  293.                                   (800) 346-1672  24 hours / 7 Days
  294.  
  295.          Online Orders via modem: (910) 350-8061  10 lines, all 14.4K
  296.                                   (910) 799-0923  Direct 28.8K line
  297.  
  298.                     via Internet: orders@bmtmicro.com
  299.                                   telnet@bmtmicro.com
  300.                                   http://www.bmtmicro.com
  301.      Secure Ordering: https://wwws.wilmington.net/bmtmicro/secure_form.html
  302.  
  303.  
  304.      Ordering and general ordering questions:
  305.  
  306.                             Via AOL: bmtmicro
  307.                             Via MSN: bmtmicro
  308.                          Via Prodigy: HNGP66D
  309.                     Via Compuserve: 74031,307
  310.  
  311.  
  312.      We accept Visa, Mastercard, Discover, American Express, Diners
  313.      Club, Carte Blanche, Cashiers Check, Personal Check.   Personal
  314.      checks are subject to clearance.  Eurochecks in DM are welcome.
  315.      DM, Sterling, and US Currency is welcome but send only by
  316.      registered mail, return receipt requested.   We cannot be liable
  317.      for lost cash sent through the mail.
  318.  
  319.      If you reside in a country with an unconvertible currency please
  320.      contact us for alternatives.
  321.  
  322.      Purchase orders are welcome, subject to approval.   The minimum
  323.      amount is $250.00.
  324.  
  325.      Information for our German customers is explained in the last
  326.      paragraph of this order form.
  327.  
  328.      _____________________________________________________________________
  329.  
  330.      Company:_____________________________________________________________
  331.  
  332.      Name:________________________________________________________________
  333.  
  334.      Address:_____________________________________________________________
  335.  
  336.              _____________________________________________________________
  337.  
  338.      City: _______________________________State/Province: ________________
  339.  
  340.      Postal/ZIP Code: ____________________Country:________________________
  341.  
  342.      Phone:_______________________________________________________________
  343.  
  344.      Fax:  _______________________________________________________________
  345.  
  346.      E-Mail #1____________________________________________________________
  347.  
  348.      E-Mail #2____________________________________________________________
  349.  
  350.  
  351.      Product                    Quantity Price  Number of copies
  352.      _________________________  ______________  ________________
  353.  
  354.      _________________________  ______________  x ____________ = + $ _______
  355.  
  356.      _________________________  ______________  x ____________ = + $ _______
  357.  
  358.      _________________________  ______________  x ____________ = + $ _______
  359.  
  360.      Latest Version on Diskette _____$3.00____  x ____________ = + $ _______
  361.  
  362.  
  363.      North Carolina Residents add 6% Sales Tax                     $ _______
  364.  
  365.      Shipping and Handling (no quantity limit / see below)         $ _______
  366.  
  367.        Email - Subject to Credit Card Verification     Free
  368.        Fax (USA/Canada)...........................     1.00 US
  369.        Fax (Non-North America)....................     2.00 US
  370.        Worldwide 1st Class .......................     Free
  371.        2nd Day Priority, USA Only ................ $   4.00 US
  372.        US Postal Service International Express
  373.          (Including Canada and Mexico), allow up to
  374.          7-10 days ............................... $  25.00 US
  375.        Airborne Select Delivery  (USA Only)        $   8.00 US
  376.        FedEx Overnight, USA Only (delivery by
  377.          3:00 pm the following day) .............. $  15.00 US
  378.        FedEx Europe/Japan (guaranteed delivery
  379.          within 3 days) .......................... $  35.00 US
  380.  
  381.  
  382.      Total:                                                      $ _______
  383.  
  384.  
  385.       For credit card payment only
  386.  
  387.       Circle one: VISA / Master / Discover / American Express / Diners
  388.  
  389.       Credit card number: _____________________________________________
  390.  
  391.       Expiration date: ________________________________________________
  392.  
  393.       Authorization signature: ________________________________________
  394.  
  395.  
  396.  
  397.                    ORDERING FROM INSIDE GERMANY ONLY
  398.                    =================================
  399.  
  400. Persons in Germany wishing to order shareware may also transfer funds
  401. into our account with Deutsche Bank.   Once the money is deposited you
  402. may either fax a confirmation to us with proof of deposit or wait until
  403. Deutsche Bank notifies us of the transaction (usually 10-18 business days).
  404. Account information is as follows:
  405.  
  406. Deutsche Bank / Frankfurt Branch
  407. Empf║nger:  Thomas Bradford
  408. Konto-Nummer: 0860221
  409. Bankleitzahl: 500-700-10
  410.  
  411. When you make the transfer, be sure to put your name and the program you
  412. are registering on the transfer.
  413.  
  414. Current exchange rates can be obtained by sending an email to
  415. dm_to_us@bmtmicro.com.   An automated reply will return todays exchange
  416. rates.
  417.  
  418. It is very important that you send us a completed order form by
  419. either email or fax if you deposit money into this account for a
  420. registration.  Fill the order form out as usual except in the credit
  421. card number field put "DEUTSCHE BANK".   We will file the order and
  422. use it to match against the deposit information we receive from the
  423. bank.
  424.  
  425.                                IMPORTANT!
  426.                                ----------
  427. When you email us your order form, we will reply with an
  428. acknowledgement.   If you do not get an acknowledgement within 24 hours
  429. please send your order again in case it was lost.  This extra bit of
  430. caution can save a lot of confusion.
  431.  
  432. If you are concerned that your order is taking too long to process, feel
  433. free to check with us about the status of your order.   It's important
  434. to all of us that you feel safe doing business with our company and
  435. please feel free to suggest ways we can improve our service to you.
  436.  
  437.  
  438.  
  439.  
  440. Ciao and thanks for your time!
  441. Max.
  442.  
  443.